home *** CD-ROM | disk | FTP | other *** search
/ Cinema Studio: Frank Herrmann / Cinema Studio - Frank Herrmann.iso / tools / pbm / manuals / ppmtoacad.man < prev    next >
Text File  |  1994-03-01  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.      ppmtoacad(1)         AMIGA (10 October 1991)         ppmtoacad(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ppmtoacad - convert portable pixmap to AutoCAD database or
  10.           slide
  11.  
  12.      SYNOPSIS
  13.           ppmtoacad [-dxb] [-poly] [-background colour] [-white] [-
  14.                     aspect ratio] [-8] [ppmfile]
  15.  
  16.      DESCRIPTION
  17.           Reads a portable pixmap as input.  Produces an AutoCAD(Reg.)
  18.           slide  file or binary database import (.dxb) file as output.
  19.           If no ppmfile is specified,  input  is  read  from  standard
  20.           input.
  21.  
  22.      OPTIONS
  23.           -dxb An  AutoCAD  binary  database  import  (.dxb)  file  is
  24.                written.  This file is read with the DXBIN command and,
  25.                once loaded, becomes part of  the  AutoCAD  geometrical
  26.                database  and  can  be viewed and edited like any other
  27.                object.  Each sequence of identical  pixels  becomes  a
  28.                separate  object  in  the  database; this can result in
  29.                very large AutoCAD drawing files.  However, if you want
  30.                to trace over a bitmap, it lets you zoom and pan around
  31.                the bitmap as you wish.
  32.  
  33.           -poly
  34.                If the -dxb option is  not  specified,  the  output  of
  35.                ppmtoacad  is an AutoCAD slide file.  Normally each row
  36.                of pixels is represented by an AutoCAD line entity.  If
  37.                -poly  is  selected,  the pixels are rendered as filled
  38.                polygons.  If the slide is viewed  on  a  display  with
  39.                higher  resolution  than  the  source pixmap, this will
  40.                cause the pixels to  expand  instead  of  appearing  as
  41.                discrete  lines  against  the screen background colour.
  42.                Regrettably, this  representation  yields  slide  files
  43.                which  occupy  more  disc  space  and  take  longer  to
  44.                display.
  45.  
  46.           -background colour
  47.                Most AutoCAD display drivers can be configured  to  use
  48.                any  available  colour  as the screen background.  Some
  49.                users perfer a black screen background,  others  white,
  50.                while splinter groups advocate burnt ocher, tawny puce,
  51.                and shocking grey.   Discarding  pixels  whose  closest
  52.                AutoCAD   colour   representation   is   equal  to  the
  53.                background colour can substantially reduce the size  of
  54.                the  AutoCAD database or slide file needed to represent
  55.                a bitmap.  If no -background colour is  specified,  the
  56.                screen  background  colour is assumed to be black.  Any
  57.                AutoCAD colour number may be specified  as  the  screen
  58.                background;  colour  numbers are assumed to specify the
  59.                hues  defined  in  the  standard  AutoCAD  256   colour
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppmtoacad(1)         AMIGA (10 October 1991)         ppmtoacad(1)
  71.  
  72.  
  73.  
  74.                palette.
  75.  
  76.           -white
  77.                Since  many  AutoCAD  users  choose  a   white   screen
  78.                background,  this  option  is  provided as a short-cut.
  79.                Specifying -white is identical in effect to -background
  80.                7.
  81.  
  82.           -aspect ratio
  83.                If the source pixmap had non-square pixels,  the  ratio
  84.                of  the pixel width to pixel height should be specified
  85.                as ratio.  The resulting slide or  .dxb  file  will  be
  86.                corrected  so that pixels on the AutoCAD screen will be
  87.                square.  For example, to correct an image  made  for  a
  88.                320x200 VGA/MCGA screen, specify -aspect 0.8333.
  89.  
  90.           -8   Restricts the colours in the output file to the  8  RGB
  91.                shades.
  92.  
  93.           All flags  can  be  abbreviated  to  their  shortest  unique
  94.           prefix.
  95.  
  96.      BUGS
  97.           AutoCAD has a fixed  palette  of  256  colours,  distributed
  98.           along  the  hue,  lightness,  and  saturation axes.  Pixmaps
  99.           which contain many nearly-identical colours, or colours  not
  100.           closely  approximated  by  AutoCAD's  palette, may be poorly
  101.           rendered.
  102.  
  103.           ppmtoacad works best if the  system  displaying  its  output
  104.           supports the full 256 colour AutoCAD palette.  Monochrome, 8
  105.           colour, and 16 colour configurations will produce less  than
  106.           optimal results.
  107.  
  108.           When creating a .dxb file or a slide  file  with  the  -poly
  109.           option, ppmtoacad finds both vertical and horizontal runs of
  110.           identical pixels  and  consolidates  them  into  rectangular
  111.           regions  to  reduce  the  size  of the output file.  This is
  112.           effective for images with large areas of constant colour but
  113.           it's no substitute for true raster to vector conversion.  In
  114.           particular, thin diagonal lines are not optimised at all  by
  115.           this process.
  116.  
  117.           Output files can be huge.
  118.  
  119.      SEE ALSO
  120.           AutoCAD Reference Manual:   Slide  File  Format  and  Binary
  121.           Drawing Interchange (DXB) Files, ppm(5)
  122.  
  123.      AUTHOR
  124.                John Walker
  125.                Autodesk SA
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ppmtoacad(1)         AMIGA (10 October 1991)         ppmtoacad(1)
  137.  
  138.  
  139.  
  140.                Avenue des Champs-Montants 14b
  141.                CH-2074 MARIN
  142.                Suisse/Schweiz/Svizzera/Svizra/Switzerland
  143.                Usenet:  kelvin@Autodesk.com
  144.                Fax:     038/33 88 15
  145.                Voice:   038/33 76 33
  146.  
  147.           Permission  to  use,  copy,  modify,  and  distribute   this
  148.           software  and  its documentation for any purpose and without
  149.           fee  is  hereby   granted,   without   any   conditions   or
  150.           restrictions.   This  software is provided ``as is'' without
  151.           express or implied warranty.
  152.  
  153.           AutoCAD and Autodesk are registered trademarks of  Autodesk,
  154.           Inc.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/1/94)
  196.  
  197.  
  198.  
  199.